home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / pwrlst36.zip / PWRLIST.DOC < prev    next >
Text File  |  1992-11-05  |  20KB  |  505 lines
  1.  
  2.  
  3.  
  4.                ▄▄▄▄▄▄    ▄▄▄▄▄▄   ▄        ▄  ▄▄▄▄▄▄  ▄────▄
  5.                █    ▀▄  ▄█    █▄  █        █  █       █    ▀▄
  6.                █─────▀  █      █  ▀▄  ┌┐  ▄▀  █────   █───▄─▀
  7.                █        ▀█    █▀   ▀▄┌┘└┐▄▀   █       █   ▀▄
  8.                ▀         ▀▀▀▀▀▀     ▀▀  ▀▀    ▀▀▀▀▀▀  ▀    ▀
  9.  
  10.                         ▄        ▄   ▄▄▄▄▄▄  ▄▄▄▄▄▄▄
  11.                         █        █  █▀    ▀     █
  12.                         █        █  ▀─────▄     █
  13.                         █        █  ▄    ▄█     █
  14.                         ▀▀▀▀▀▀▀  ▀  ▀▀▀▀▀▀      ▀
  15.  
  16.  
  17.                               version  3.0
  18.  
  19.                                    by
  20.  
  21.                               Mike Weaver
  22.  
  23.  
  24.  
  25.  
  26.                                CONTENTS
  27.                                ========
  28.                                                                              
  29.                               Overview
  30.                               Copyright
  31.                               Warranty
  32.                               Distribution
  33.                               Registration
  34.                               List of files in archive
  35.                               Configuration Files
  36.                               Environment Variables
  37.                               Batch File
  38.                               Sysop Keys
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                                  OVERVIEW
  50.                                  --------
  51.  
  52. Power List is a utility for PCBoard 14.x, although it has not been tested
  53. on any other systems it should work fine with any system that can produce
  54. a DOOR.SYS, PCBOARD.SYS, USERINFO.DAT, DORINFOx.DEF, CALLINFO.BBS and a
  55. few others.
  56.  
  57. Power List allows the user to design and download a custom built list of
  58. available files on a particular BBS. Hence the name.  Rather than tying up
  59. your system to download a very large complete file listing the user selects
  60. those files areas that interest him/her and then Power List will do the rest.
  61.  
  62. Using PKZip(tm) Power List will compress all the selected file directories
  63. and then using DSZ(tm) it will allow the user to download the list.
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                                Copyright
  73.                                ---------
  74.  
  75. POWER LIST,  Copyright (c) 1992 by Mike Weaver,  is being distributed as
  76. Shareware.  Under this concept you may use the  SHAREWARE (unregistered)
  77. version for a  reasonable period of  time for evaluation after which you
  78. must either register your copy or discontinue  usage.
  79.  
  80.  
  81.  
  82.                          DISCLAIMER - WARRANTY
  83.                          ~~~~~~~~~~~~~~~~~~~~~
  84. This product is provided as is without warranty of any kind.  The entire
  85. risk as to the results and performance of the program is assumed by you.
  86. Futhermore, the  author does not warrant, guarantee, or  make any  other
  87. representations regarding the use of,  or the  results of the use of the
  88. program,  and you rely on the  program and  results  solely at  your own
  89. risk.  The author  cannot and will not accept  responsibility for system
  90. damage, loss of profit or any other special, consequential or incidental 
  91. damages  resulting  from  the use of or inability to  use this  product.
  92.  
  93.  
  94.  
  95.                              Distribution
  96.                              ------------
  97.  
  98. This program is being distributed via the SHAREWARE concept and as such,
  99. may be copied freely with the following restrictions:
  100.  
  101.         * The program must be supplied in it's original unmodified
  102.           form, including documentation.
  103.  
  104.         * This program may not be distributed as part of any commercial
  105.           application or service without the express, written consent
  106.           of the author.
  107.  
  108.         * Vendors of Shareware/Public Domain software may not
  109.           distribute this program without the express, written
  110.           consent of the author.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                              Registration
  118.                              ------------
  119.  
  120. This door represents  many hours of  programming and the author deserves
  121. just compensation for his time, efforts and expertise.  If you find this
  122. program to be of some  value and you  continue to use it on your system,
  123. you must return the order form provided along with the registration fee.
  124. Registration entitles you to free upgrades via modem from The NITE-LITE.
  125. Payments should be  made in the  form of a check or money order.
  126.  
  127.                 The NITE-LITE bbs: (615) 458-9099 v.32bis
  128.  
  129. NOTE: After I recieve your registration fee,  your registration number
  130.       will be posted in a private message on The NITE-LITE.
  131.  
  132.         I have not crippled this program in any way, so you can use it
  133.         forever if you like.  However be forewarned that unless you
  134.         register I may not be apt to answer questions as freely.  I
  135.         too however realize the cost of running a BBS so I ask only a
  136.         mere $10 if you like and use the program.  If you do not like
  137.         the program and have an idea that would make it more likeable
  138.         by all means let me know and I will try to implement it.
  139.  
  140.                       List of Files in archive:
  141.                       -------------------------
  142.           Sample.cfg                             Pwrlist.doc
  143.           Pwrlist.exe                            Pwrlist.
  144.           File_id.diz        NiteLite.txt        History.doc
  145.  
  146. SAMPLE.CFG    This is the door configuration file.  The one included in
  147.               this archive is a sample and will have to be edited to fit
  148.               your system.
  149. PWRLIST.DOC   Three guesses and the first 2 don't count. <Grin>
  150. PWRLIST.EXE   The executable door program itself.  This door is a stand
  151.               alone program that requires no other files such as DoorPatch
  152.               or Brun. I wrote this door using DoorFrame 3.8
  153. PWRLIST.      This is a sample batch file to run the door on PCBoard
  154.               systems.  You may have to edit it depending on where you
  155.               store the door files etc.
  156. FILE_ID.DIZ   This file contains program descriptions for boards that
  157.               implement automatic file description insertion with a
  158.               program such as PCBDescribe(tm).
  159. NITELITE.TXT  This is a small ad for my BBS.
  160. HISTORY.DOC   A list of corrections or bug fixes or changes in Power List
  161.  
  162.  
  163.  
  164. Example configuration file for|PCBOARD.SYS|
  165. ------------------------------------------
  166.  
  167. C:\PCB\PCBOARD.SYS    <=-  (Full pathname of your PCBOARD.SYS file)
  168. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  169. Mike                  <=-  (The Sysop's first name)
  170. Weaver                <=-  (The Sysop's last name)
  171. 662345922             <=-  (Your registration #)  Use this one till you get one
  172. c:\pcb\menus\dirs     <=-  (Location of your file directory menu)
  173. c:\pcb\gen\           <=-  (Hard drive location of dir files) backslash a must
  174. 60                    <=-  (Number of dir files available)
  175. dos1                  <=-  (From here to the end of the config file is the
  176. dos2                        file names of each of the dir files you want
  177. dos3                        to be accessable by Power List)
  178. dos4
  179. dos5
  180. dos6
  181. dos7
  182. etc.
  183. etc.
  184. etc.
  185.  
  186. Example configuration file for|USERS.SYS|
  187. ------------------------------------------
  188.  
  189. C:\PCB\USERS.SYS      <=-  (Full pathname of your USERS.SYS file)
  190. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  191. Mike                  <=-  (The Sysop's first name)
  192. Weaver                <=-  (The Sysop's last name)
  193. 662345922             <=-  (Your registration #)  Use this one till you get one
  194. c:\pcb\menus\dirs     <=-  (Location of your file directory menu)
  195. c:\pcb\gen\           <=-  (Hard drive location of dir files) backslash a must
  196. 60                    <=-  (Number of dir files available)
  197. dos1                  <=-  (From here to the end of the config file is the
  198. dos2                        file names of each of the dir files you want
  199. dos3                        to be accessable by Power List)
  200. dos4
  201. dos5
  202. dos6
  203. dos7
  204. etc.
  205. etc.
  206. etc.
  207.  
  208.  
  209. Example configuration file for|DOOR.SYS|
  210. ---------------------------------------
  211.  
  212. C:\BBS\DOOR.SYS       <=-  (Full pathname of your DOOR.SYS file)
  213. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  214. Mike                  <=-  (The Sysop's first name)
  215. Weaver                <=-  (The Sysop's last name)
  216. 662345922             <=-  (Your registration #)  Use this one till you get one
  217. c:\pcb\menus\dirs     <=-  (Location of your file directory menu)
  218. c:\pcb\gen\           <=-  (Hard drive location of dir files) backslash a must
  219. 60                    <=-  (Number of dir files available)
  220. dos1                  <=-  (From here to the end of the config file is the
  221. dos2                        file names of each of the dir files you want
  222. dos3                        to be accessable by Power List)
  223. dos4
  224. dos5
  225. dos6
  226. dos7
  227. etc.
  228. etc.
  229. etc.
  230.  
  231.  
  232. Example configuration file for|USERINFO.DAT|
  233. -------------------------------------------
  234.  
  235. C:\BBS\USERINFO.DAT   <=-  (Full pathname of your USERINFO.DAT file)
  236. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  237. Mike                  <=-  (The Sysop's first name)
  238. Weaver                <=-  (The Sysop's last name)
  239. 662345922             <=-  (Your registration #)  Use this one till you get one
  240. c:\pcb\menus\dirs     <=-  (Location of your file directory menu)
  241. c:\pcb\gen\           <=-  (Hard drive location of dir files) backslash a must
  242. 60                    <=-  (Number of dir files available)
  243. dos1                  <=-  (From here to the end of the config file is the
  244. dos2                        file names of each of the dir files you want
  245. dos3                        to be accessable by Power List)
  246. dos4
  247. dos5
  248. dos6
  249. etc.
  250. etc.
  251. etc.
  252.  
  253. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  254.  
  255. Example configuration file for|CALLINFO.BBS|
  256. -------------------------------------------
  257.  
  258. C:\BBS\CALLINFO.BBS   <=-  (Full pathname of your CALLINFO.BBS file)
  259. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  260. Mike                  <=-  (The Sysop's first name)
  261. Weaver                <=-  (The Sysop's last name)
  262. 662345922             <=-  (Your registration #)  Use this one till you get one
  263. c:\pcb\menus\dirs     <=-  (Location of your file directory menu)
  264. c:\pcb\gen\           <=-  (Hard drive location of dir files) backslash a must
  265. 60                    <=-  (Number of dir files available)
  266. dos1                  <=-  (From here to the end of the config file is the
  267. dos2                        file names of each of the dir files you want
  268. dos3                        to be accessable by Power List)
  269. dos4
  270. dos5
  271. dos6
  272. dos7
  273. etc.
  274. etc.
  275. etc.
  276.  
  277.  
  278. Example configuration file for|DORINFOx.DEF|
  279. -------------------------------------------
  280.  
  281. C:\BBS\DORINFOx.DEF   <=-  (Full pathname of your DORINFOx.DEF file)
  282.                       <=-  (Change this to your BBS name)
  283. The NITE-LITE bbs     <=-  (The Sysop's first name)
  284. Mike                  <=-  (The Sysop's last name)
  285. Weaver                <=-  (Your registration #)  Use this one till you get one
  286. 662345922             <=-  (Location of your file directory menu)
  287. c:\pcb\menus\dirs     <=-  (Hard drive location of dir files) backslash a must
  288. c:\pcb\gen\           <=-  (Number of dir files available)
  289. 60                    <=-  (From here to the end of the config file is the
  290. dos1                        file names of each of the dir files you want
  291. dos2                        to be accessable by Power List)
  292. dos3
  293. dos4
  294. dos5
  295. dos6
  296. dos7
  297. etc.
  298. etc.
  299. etc.
  300.  
  301. Example configuration file for|SFDOORS.DAT|
  302. ------------------------------------------
  303.  
  304. C:\BBS\SFDOORS.DAT    <=-  (Full pathname of your SFDOORS.DAT file)
  305. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  306. Mike                  <=-  (The Sysop's first name)
  307. Weaver                <=-  (The Sysop's last name)
  308. 662345922             <=-  (Your registration #)  Use this one till you get one
  309. c:\pcb\menus\dirs     <=-  (Location of your file directory menu)
  310. c:\pcb\gen\           <=-  (Hard drive location of dir files) backslash a must
  311. 60                    <=-  (Number of dir files available)
  312. dos1                  <=-  (From here to the end of the config file is the
  313. dos2                        file names of each of the dir files you want
  314. dos3                        to be accessable by Power List)
  315. dos4
  316. dos5
  317. dos6
  318. dos7
  319. etc.
  320. etc.
  321. etc.
  322.  
  323.  
  324. Example configuration file for|CHAIN.TXT|
  325. ----------------------------------------
  326.  
  327. C:\BBS\CHAIN.TXT      <=-  (Full pathname of your CHAIN.TXT file)
  328. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  329. Mike                  <=-  (The Sysop's first name)
  330. Weaver                <=-  (The Sysop's last name)
  331. 662345922             <=-  (Your registration #)  Use this one till you get one
  332. c:\pcb\menus\dirs     <=-  (Location of your file directory menu)
  333. c:\pcb\gen\           <=-  (Hard drive location of dir files) backslash a must
  334. 60                    <=-  (Number of dir files available)
  335. dos1                  <=-  (From here to the end of the config file is the
  336. dos2                        file names of each of the dir files you want
  337. dos3                        to be accessable by Power List)
  338. dos4
  339. dos5
  340. dos6
  341. dos7
  342. etc.
  343. etc.
  344. etc.
  345.  
  346.  
  347. Example configuration file for|TRIBBS.SYS|
  348. ----------------------------------------
  349.  
  350. C:\BBS\TRIBBS.SYS     <=-  (Full pathname of your TRIBBS.SYS file)
  351. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  352. Mike                  <=-  (The Sysop's first name)
  353. Weaver                <=-  (The Sysop's last name)
  354. 662345922             <=-  (Your registration #)  Use this one till you get one
  355. c:\pcb\menus\dirs     <=-  (Location of your file directory menu)
  356. c:\pcb\gen\           <=-  (Hard drive location of dir files) backslash a must
  357. 60                    <=-  (Number of dir files available)
  358. dos1                  <=-  (From here to the end of the config file is the
  359. dos2                        file names of each of the dir files you want
  360. dos3                        to be accessable by Power List)
  361. dos4
  362. dos5
  363. dos6
  364. dos7
  365. etc.
  366. etc.
  367. etc.
  368.  
  369.  
  370. Line 1 ->  Is the location of your BBS info file. The program requires
  371.            the complete path and filename. I recommend using USERS.SYS
  372.            for PCBoard use.
  373. Line 2 ->  The name of your BBS goes here.
  374. Line 3 ->  The SysOp's first name.
  375. Line 4 ->  The SysOp's last name.
  376. Line 5 ->  This is where you put your serial number once you register the
  377.            program.  Until then use any 9 digit number you like but don't
  378.            leave this line out or the door will crash!
  379. Line 6 ->  This is the location of your file directory menu.  The example
  380.            above is from my system, use whatever you use in PCBSetup.
  381.            Or you can create a special directory menu if you like just
  382.            be sure to tell the config file when to find it.
  383. Line 7 ->  This is the hard drive directory path to your individual files
  384.            directories.  In other words the directory where the dir files
  385.            are stored.  !! Important !!  The trailing backslash is a must!
  386. Line 8 ->  This number represents the total number of dir files on your
  387.            system.  This number needs to match the number of entries in
  388.            the next instruction.
  389. Line 9 ->  From here to the end of the .cfg file is where you tell the
  390.            program the name of each of your systems dir files.  Using this
  391.            method seemed more versatile to me.  The unregistered version
  392.            is not crippled and will handle as many directories as you
  393.            need to.  However if you use the door Please Register.
  394.  
  395.  
  396.                          Environment Variables
  397.                          ---------------------
  398.  
  399. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  400. variables. Non-PCBoard systems may also use these variables by including
  401. the following in either your BBS batch or AUTOEXEC.BAT
  402.  
  403.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  404.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  405.  
  406. Then in your Door .CNF file instead of putting C:\BBSDIR\DOOR.SYS, you
  407. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  408. .CNF file for multi-node operation!
  409.  
  410. To specify a non-standard IRQ, put the IRQ number after the .CNF on the
  411. command line.  For example:
  412.  
  413.      PWRLIST PWRLIST.CNF /5
  414.  
  415. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  416.  
  417.      PWRLIST PWRLIST.CNF /%IRQ%
  418.  
  419. This tells the program to use IRQ 5 instead of the standard IRQ.
  420.  
  421.  
  422. !!!! I have only run and tested this door with PCBoard 14.5a and I cannot !!!!
  423. !!!! attest to its ability to run on any other systems. Consider yourself !!!!
  424. !!!! warned in advance.                                                   !!!!
  425.  
  426.  
  427.                           Example Batch File
  428.                          -------------------
  429.  
  430. A sample batch file is included and is similer to the following:
  431.  
  432.    ECHO OFF
  433.    CD\DOORS\PWRLIST         <=- Switch to the door's Directory.
  434.    PWRLIST PWRLIST.CNF      <=- Execute the door program and pass the
  435.                                 configuration filename to the program.
  436.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  437.    BOARD                    <=- Restart BBS.
  438.  
  439. This Door is multi-node  compatible so you may run more than 1 node from
  440. the same .CNF file  provided the path to your system file (DORINFOx.DEF,
  441. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  442. variables, (q.v.)
  443.  
  444.  
  445.                               Sysop Keys
  446.                               ----------
  447. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  448.          written to DOOR.SYS and USERS.SYS
  449. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  450.          and/or written to DOOR.SYS and USERS.SYS
  451. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  452. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  453.          and/or written to DOOR.SYS and USERS.SYS
  454. F8    -  Returns the caller involuntarily to the BBS.
  455. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  456.          and/or written to DOOR.SYS and USERS.SYS
  457. F10   -  Activates SysOp CHAT mode within the DOOR.
  458. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  459. UP    -  Give the caller extra time while in the DOOR.  
  460. DN    -  Subtract time from the caller while in the DOOR. 
  461. HOME  -  HELP key for Status Line options.
  462. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  463. ALT-X -  PCBoard will exit after current caller logs off. Value is
  464.          passed to PCBoard. Not available on non-PCBoard systems.
  465.  
  466.  
  467. One last thing I am terrible at writing so if these docs seem hard to read
  468. or use it is probably because they are. <GRIN>
  469.  
  470.  
  471.                                CREDITS
  472.                                -------
  473.  
  474.         I want to thank Todd Stephens for his unending help when my
  475.         needs overcome my ability.
  476.  
  477.         I also want to thank Ted Freeman for his great program Door-
  478.         Frame, as well as for his never ending help as I tried to
  479.         convert Power List over to use DoorFrame and in turn be much
  480.         more versatile.
  481.  
  482.  
  483.                      OK I'm finished, send the millions to:
  484.  
  485.                                 Mike Weaver
  486.                                 % The NITE-LITE bbs
  487.                                 Rt. 1 Box 231b
  488.                                 159 Moatsewell Rd.
  489.                                 Philadelphia, Tn.
  490.                                                37846
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.